Skip to main content
Splunk® Enterprise

REST API Reference Manual

Splunk® Enterprise
9.4.0 (latest release)

License endpoint descriptions

Manage licensing configurations.

Usage details

Review ACL information for an endpoint

To check Access Control List (ACL) properties for an endpoint, append /acl to the path. For more information see Access Control List in the REST API User Manual.

Authentication and Authorization

Username and password authentication is required for access to endpoints and REST operations.

Splunk users must have role and/or capability-based authorization to use REST endpoints. Users with an administrative role, such as admin, can access authorization information in Splunk Web. To view the roles assigned to a user, select Settings > Access controls and click Users. To determine the capabilities assigned to a role, select Settings > Access controls and click Roles.

App and user context

Typically, knowledge objects, such as saved searches or event types, have an app/user context that is the namespace. For more information about specifying a namespace, see Namespace in the REST API User Manual.

Splunk Cloud Platform limitations

As a Splunk Cloud Platform user, you are restricted to interacting with the search tier only with the REST API. License endpoints are generally not accessible in Splunk Cloud Platform.

See Access requirements and limitations for the Splunk Cloud Platform REST API in the the REST API Tutorials manual for more information.


licenser/groups

https://<host>:<mPort>/services/licenser/groups

Provides access to the configuration of licenser groups.

A licenser group contains one or more licenser stacks that can operate concurrently. Only one licenser group is active at any given time.

GET

Expand

Lists all licenser groups.


licenser/groups/{name}

https://<host>:<mPort>/services/licenser/groups/{name}


Manage the {name} licenser group.


GET

Expand

List a specific licenser group.


POST

Expand

Activate a specific licenser group and deactivate the previously active one.



licenser/licenses

https://<host>:<mPort>/services/licenser/licenses


Provides access to the licenses for this Splunk Enterprise instance.

A license enables various features for a Splunk instance, including but not limited to indexing quota, auth, search, forwarding.


GET

Expand

List all licenses added.


POST

Expand

Add a license entitlement to the current instance.


licenser/licenses/{name}

https://<host>:<mPort>/services/licenser/licenses/{name}

Access or delete the {name} license.


DELETE

Expand

Delete the license with a hash corresponding to {name}


GET

Expand

List license details.


licenser/localpeer

https://<host>:<mPort>/services/licenser/localpeer

Get license state information for the Splunk instance.

GET

Expand

Get license state information for the Splunk instance.


licenser/messages

https://<host>:<mPort>/services/licenser/messages

Access licenser messages.

Messages may range from helpful warnings about being close to violations, licenses expiring or more severe alerts regarding overages and exceeding license warning window.


GET

Expand

List all messages/alerts/persisted warnings for this node.


licenser/messages/{name}

https://<host>:<mPort>/services/licenser/messages/{name}

Get the message with message ID {name}.


GET

Expand

List specific message whose msgId corresponds to {name} component.


licenser/pools

https://<host>:<mPort>/services/licenser/pools


Access the licenser pools configuration.

A pool logically partitions the daily volume entitlements of a stack. You can use a license pool to divide license privileges amongst multiple peers.


GET

Expand

Enumerate all pools.


POST

Expand

Create a license pool.


licenser/pools/{name}

https://<host>:<mPort>/services/licenser/pools/{name}


Manage the {name} license pool.


DELETE

Expand

Delete the specified pool.


GET

Expand

Lists details of the pool specified by {name}.


POST

Expand

Edit properties of the pool specified by {name}.


licenser/peers

https://<host>:<mPort>/services/licenser/peers


Access license peer instances.


GET

Expand

List all peers registered to this license manager.


licenser/peers/{name}

https://<host>:<mPort>/services/licenser/peers/{name}


Get {name} licenser peer license information.


GET

Expand

List attributes of the peer instance specified by {name}.


licenser/stacks

https://<host>:<mPort>/services/licenser/stacks


Provides access to the license stack configuration.

A license stack is comprised of one or more licenses of the same "type". The daily indexing quota of a license stack is additive, so a stack represents the aggregate entitlement for a collection of licenses.

GET

Expand

Enumerate all license stacks.


licenser/stacks/{name}

https://<host>:<mPort>/services/licenser/stacks/{name}


Get {name} license stack information.


GET

Expand

Retrieve details of a specific license stack.


licenser/usage

https://<host>:<mPort>/services/licenser/usage


Get current license usage stats from the last minute, since midnight server time.

GET

Expand

Enumerate license usage information from the last minute, since midnight server time.


Last modified on 05 October, 2023
KV store endpoint descriptions   Metrics Catalog endpoint descriptions

This documentation applies to the following versions of Splunk® Enterprise: 9.0.0, 9.0.1, 9.0.2, 9.0.3, 9.0.4, 9.0.5, 9.0.6, 9.0.7, 9.0.8, 9.0.9, 9.0.10, 9.1.0, 9.1.1, 9.1.2, 9.1.3, 9.1.4, 9.1.5, 9.1.6, 9.1.7, 9.2.0, 9.2.1, 9.2.2, 9.2.3, 9.2.4, 9.3.0, 9.3.1, 9.3.2, 9.4.0


Was this topic useful?







You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters